home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3n / xdr_admin.z / xdr_admin
Encoding:
Text File  |  2002-10-03  |  5.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. xxxxddddrrrr____aaaaddddmmmmiiiinnnn((((3333NNNN))))                                                    xxxxddddrrrr____aaaaddddmmmmiiiinnnn((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _xxxx_dddd_rrrr______aaaa_dddd_mmmm_iiii_nnnn:  _xxxx_dddd_rrrr______gggg_eeee_tttt_pppp_oooo_ssss, _xxxx_dddd_rrrr______iiii_nnnn_llll_iiii_nnnn_eeee, _xxxx_dddd_rrrr_rrrr_eeee_cccc______eeee_oooo_ffff, _xxxx_dddd_rrrr______ssss_eeee_tttt_pppp_oooo_ssss - library
  10.      routines for external data representation
  11.  
  12. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  13.      XDR library routines allow C programmers to describe arbitrary data
  14.      structures in a machine-independent fashion.  Protocols such as remote
  15.      procedure calls (RPC) use these routines to describe the format of the
  16.      data.
  17.  
  18.      These routines deal specifically with the management of the XDR stream.
  19.  
  20.    RRRRoooouuuuttttiiiinnnneeeessss
  21.      See _rrrr_pppp_cccc(3N) for the definition of the _XXXX_DDDD_RRRR data structure.
  22.  
  23.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_rrrr_pppp_cccc_////_xxxx_dddd_rrrr_...._hhhh_>>>>
  24.  
  25.      _uuuu______iiii_nnnn_tttt
  26.      _xxxx_dddd_rrrr______gggg_eeee_tttt_pppp_oooo_ssss_((((_cccc_oooo_nnnn_ssss_tttt _XXXX_DDDD_RRRR _****_xxxx_dddd_rrrr_ssss_))))_;;;;
  27.  
  28.           A macro that invokes the get-position routine associated with the
  29.           XDR stream, _x_d_r_s.  The routine returns an unsigned integer, which
  30.           indicates the position of the XDR byte stream.  A desirable feature
  31.           of XDR streams is that simple arithmetic works with this number,
  32.           although the XDR stream instances need not guarantee this.
  33.           Therefore, applications written for portability should not depend on
  34.           this feature.
  35.  
  36.      _llll_oooo_nnnn_gggg _****
  37.      _xxxx_dddd_rrrr______iiii_nnnn_llll_iiii_nnnn_eeee_((((_XXXX_DDDD_RRRR _****_xxxx_dddd_rrrr_ssss_;;;; _cccc_oooo_nnnn_ssss_tttt _iiii_nnnn_tttt _llll_eeee_nnnn_))))_;;;;
  38.  
  39.           A macro that invokes the in-line routine associated with the XDR
  40.           stream, _x_d_r_s.  The routine returns a pointer to a contiguous piece
  41.           of the stream's buffer; _l_e_n is the byte length of the desired
  42.           buffer.  Note:  pointer is cast to _llll_oooo_nnnn_gggg _****.
  43.  
  44.           Note:  _xxxx_dddd_rrrr______iiii_nnnn_llll_iiii_nnnn_eeee may return _NNNN_UUUU_LLLL_LLLL (_0000) if it cannot allocate a
  45.           contiguous piece of a buffer.  Therefore the behavior may vary among
  46.           stream instances; it exists for the sake of efficiency, and
  47.           applications written for portability should not depend on this
  48.           feature.
  49.  
  50.      _bbbb_oooo_oooo_llll______tttt
  51.      _xxxx_dddd_rrrr_rrrr_eeee_cccc______eeee_oooo_ffff_((((_XXXX_DDDD_RRRR _****_xxxx_dddd_rrrr_ssss_))))_;;;;
  52.  
  53.           This routine can be invoked only on streams created by
  54.           _xxxx_dddd_rrrr_rrrr_eeee_cccc______cccc_rrrr_eeee_aaaa_tttt_eeee.  After consuming the rest of the current record in
  55.           the stream, this routine returns _1111 if the stream has no more input,
  56.           _0000 otherwise.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. xxxxddddrrrr____aaaaddddmmmmiiiinnnn((((3333NNNN))))                                                    xxxxddddrrrr____aaaaddddmmmmiiiinnnn((((3333NNNN))))
  71.  
  72.  
  73.  
  74.      _bbbb_oooo_oooo_llll______tttt
  75.      _xxxx_dddd_rrrr______ssss_eeee_tttt_pppp_oooo_ssss_((((_XXXX_DDDD_RRRR _****_xxxx_dddd_rrrr_ssss_,,,, _cccc_oooo_nnnn_ssss_tttt _uuuu______iiii_nnnn_tttt _pppp_oooo_ssss_))))_;;;;
  76.  
  77.           A macro that invokes the set position routine associated with the
  78.           XDR stream _x_d_r_s.  The parameter _p_o_s is a position value obtained
  79.           from _xxxx_dddd_rrrr______gggg_eeee_tttt_pppp_oooo_ssss.  This routine returns _1111 if the XDR stream was
  80.           repositioned, and _0000 otherwise.
  81.  
  82.           Note:  it is difficult to reposition some types of XDR streams, so
  83.           this routine may fail with one type of stream and succeed with
  84.           another.  Therefore, applications written for portability should not
  85.           depend on this feature.
  86.  
  87. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.      _rrrr_pppp_cccc(3N), _xxxx_dddd_rrrr______cccc_oooo_mmmm_pppp_llll_eeee_xxxx(3N), _xxxx_dddd_rrrr______cccc_rrrr_eeee_aaaa_tttt_eeee(3N), _xxxx_dddd_rrrr______ssss_iiii_mmmm_pppp_llll_eeee(3N)
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.